newCard

Type

message

Summary

Sent to a new card right after it's created.

Syntax

newCard

Description

Handle the newCard message if you want to create additional objects, switch tools, or do other tasks when a new card is created.

Normally, the newCard message is handled at a higher level of the message path, since the newly-created card does not yet have a script unless the templateCard contains one.

The actual creation is not triggered by the newCard message, so trapping the message and not allowing it to pass does not prevent the card from being created.

Examples

on newCard -- ask the user to name the new card
  ask "What do you want to call this card?"
  if the result is "Cancel" then delete the target
  else set the name of the target to it
end newCard

Related

keyword: card, templateCard

message: newBackground

property: script

command: create card, paste, copy, clone

control structure: pass

glossary: object, trap, message, tool, message path

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

windows

linux

ios

android

Platforms

desktop

server

mobile